home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / inet / internet-drafts / draft-ietf-bgp-mibv4-03.txt < prev    next >
Text File  |  1993-08-24  |  61KB  |  1,676 lines
  1.  
  2. Network Working Group                                        S. Willis
  3. INTERNET DRAFT                                              J. Burruss
  4.                                          Wellfleet Communications Inc.
  5.                                                                 J. Chu
  6.                                                               IBM Corp
  7.                                                        August 18, 1993
  8.  
  9.  
  10.                      Definitions of Managed Objects
  11.               for the Border Gateway Protocol (Version 4)
  12.  
  13.  
  14. Status of this Memo
  15.  
  16.    This document is an Internet Draft.  Internet Drafts are working
  17.    documents of the Internet Engineering Task Force (IETF), its Areas,
  18.    and its Working Groups.  Note that other groups may also distribute
  19.    working documents as Internet Drafts.
  20.  
  21.    Internet Drafts are draft documents valid for a maximum of six
  22.    months. Internet Drafts may be updated, replaced, or obsoleted by
  23.    other documents at any time.  It is not appropriate to use Internet
  24.    Drafts as reference material or to cite them other than as a "working
  25.    draft" or "work in progress."
  26.  
  27.    Please check the I-D abstract listing contained in each Internet
  28.    Draft directory to learn the current status of this or any other
  29.    Internet Draft.
  30.  
  31.    This memo is an extension to the SNMP MIB.  It specifies an IAB
  32.    standards track protocol for the Internet community, and requests
  33.    discussion and suggestions for improvements.  The origin of this memo
  34.    is from RFC 1269 "Definitions of Managed Objects for the Board
  35.    Gateway Protocol (Version 3)" written by the first two authors of
  36.    this memo.
  37.  
  38.    Distribution of this memo is unlimited.  Please forward comments to
  39.    bgp@ans.net.
  40.  
  41.  
  42. 1.  Abstract
  43.  
  44.    This memo defines a portion of the Management Information Base (MIB)
  45.    for use with network management protocols in TCP/IP-based internets.
  46.    In particular, it defines objects for managing the Border Gateway
  47.    Protocol [11,12].
  48.  
  49.  
  50.  
  51.  
  52.  
  53. Expiration Date March 1994                              [Page 1]
  54.  
  55.  
  56.  
  57.  
  58.  
  59. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  60.  
  61.  
  62. 2.  The Network Management Framework
  63.  
  64.    The Internet-standard Network Management Framework consists of three
  65.    components.  They are:
  66.  
  67.       RFC 1155 which defines the SMI, the mechanisms used for describing
  68.       and naming objects for the purpose of management.  RFC 1212
  69.       defines a more concise description mechanism, which is wholly
  70.       consistent with the SMI.
  71.  
  72.       RFC 1213 which defines MIB-II, the core set of managed objects for
  73.       the Internet suite of protocols.
  74.  
  75.       RFC 1157 which defines the SNMP, the protocol used for network
  76.       access to managed objects.
  77.  
  78.    The Framework permits new objects to be defined for the purpose of
  79.    experimentation and evaluation.
  80.  
  81.  
  82. 3.  Objects
  83.  
  84.    Managed objects are accessed via a virtual information store, termed
  85.    the Management Information Base or MIB.  Objects in the MIB are
  86.    defined using the subset of Abstract Syntax Notation One (ASN.1) [7]
  87.    defined in the SMI.  In particular, each object has a name, a syntax,
  88.    and an encoding.  The name is an object identifier, an
  89.    administratively assigned name, which specifies an object type.  The
  90.    object type together with an object instance serves to uniquely
  91.    identify a specific instantiation of the object.  For human
  92.    convenience, we often use a textual string, termed the OBJECT
  93.    DESCRIPTOR, to also refer to the object type.
  94.  
  95.    The syntax of an object type defines the abstract data structure
  96.    corresponding to that object type.  The ASN.1 language is used for
  97.    this purpose.  However, the SMI [3] purposely restricts the ASN.1
  98.    constructs which may be used.  These restrictions are explicitly made
  99.    for simplicity.
  100.  
  101.    The encoding of an object type is simply how that object type is
  102.    represented using the object type's syntax.  Implicitly tied to the
  103.    notion of an object type's syntax and encoding is how the object type
  104.    is represented when being transmitted on the network.
  105.  
  106.    The SMI specifies the use of the basic encoding rules of ASN.1 [8],
  107.    subject to the additional requirements imposed by the SNMP.
  108.  
  109.  
  110.  
  111.  
  112.  
  113. Expiration Date March 1994                              [Page 2]
  114.  
  115.  
  116.  
  117.  
  118.  
  119. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  120.  
  121.  
  122. 3.1.  Format of Definitions
  123.  
  124.    Section 5 contains contains the specification of all object types
  125.    contained in this MIB module.  The object types are defined using the
  126.    conventions defined in the SMI, as amended by the extensions
  127.    specified in [9,10].
  128.  
  129.  
  130. 4.  Overview
  131.  
  132.    These objects are used to control and manage a BGP [11,12]
  133.    implementation.
  134.  
  135.    The Border Gateway Protocol (BGP) is an inter-Autonomous System
  136.    routing protocol.  The primary function of a BGP speaking system is
  137.    to exchange network reachability information with other BGP systems.
  138.    This network reachability information includes information on the
  139.    full path of Autonomous Systems that traffic must transit to reach
  140.    these networks.
  141.  
  142.    BGP runs over a reliable transport protocol.  This eliminates the
  143.    need to implement explicit update fragmentation, retransmission,
  144.    acknowledgement, and sequencing.  Any authentication scheme used by
  145.    the transport protocol may be used in addition to BGP's own
  146.    authentication mechanisms.
  147.  
  148.    The planned use of BGP in the Internet environment, including such
  149.    issues as topology, the interaction between BGP and IGPs, and the
  150.    enforcement of routing policy rules is presented in a companion
  151.    document [12].
  152.  
  153.    Apart from a few system-wide scalar objects, this MIB is broken into
  154.    four tables: the BGP External Peer Table, the BGP Internal Peer
  155.    Table, the BGP Received Path Attribute Table, and the BGP-4 Received
  156.    Path Attribute Table.  The BGP External Peer Table and the BGP
  157.    Internal Peer Table contain information about state and current
  158.    activity of connections with the BGP peers external and internal to
  159.    the local AS, respectively.  The Received Path Attribute Table
  160.    contains path attributes received from all peers running BGP version
  161.    3 or less. The BGP-4 Received Path Attribute Table contains path
  162.    attributes received from all BGP-4 peers.  The actual attributes used
  163.    in determining a route are a subset of the received attribute tables
  164.    after local routing policy has been applied.
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173. Expiration Date March 1994                              [Page 3]
  174.  
  175.  
  176.  
  177.  
  178.  
  179. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  180.  
  181.  
  182. 5.  Definitions
  183.  
  184.                RFCxxxx-MIB DEFINITIONS ::= BEGIN
  185.  
  186.                IMPORTS
  187.                     NetworkAddress, IpAddress, Counter
  188.                          FROM RFC1155-SMI
  189.                     mib-2
  190.                          FROM RFC1213-MIB
  191.                   OBJECT-TYPE
  192.                          FROM RFC-1212
  193.                     TRAP-TYPE
  194.                          FROM RFC-1215;
  195.  
  196.                -- This MIB module uses the extended OBJECT-TYPE macro as
  197.                -- defined in [9], and the TRAP-TYPE macro as defined
  198.                -- in [10].
  199.  
  200.                bgp     OBJECT IDENTIFIER ::= { mib-2 15 }
  201.  
  202.  
  203.                bgpVersion OBJECT-TYPE
  204.                     SYNTAX OCTET STRING
  205.                     ACCESS read-only
  206.                     STATUS mandatory
  207.                     DESCRIPTION
  208.                          "Vector of supported BGP protocol version
  209.                           numbers.  Each peer negotiates the version from
  210.                           this vector.  Versions are identified via the
  211.                           string of bits contained within this object.
  212.                           The first octet contains bits 0 to 7, the
  213.                           second octet contains bits 8 to 15, and so on,
  214.                           with the most significant bit referring to the
  215.                           lowest bit number in the octet (e.g., the MSB
  216.                           of the first octet refers to bit 0).  If a bit,
  217.                           i, is present and set, then the version (i+1)
  218.                           of the BGP is supported."
  219.                     ::= { bgp 1 }
  220.  
  221.                bgpLocalAs OBJECT-TYPE
  222.                     SYNTAX INTEGER (0..65535)
  223.                     ACCESS read-only
  224.                     STATUS mandatory
  225.                     DESCRIPTION
  226.                          "The local autonomous system number."
  227.                     ::= { bgp 2 }
  228.  
  229.                bgpIdentifier OBJECT-TYPE
  230.  
  231.  
  232.  
  233. Expiration Date March 1994                              [Page 4]
  234.  
  235.  
  236.  
  237.  
  238.  
  239. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  240.  
  241.  
  242.                     SYNTAX IpAddress
  243.                     ACCESS read-only
  244.                     STATUS mandatory
  245.                     DESCRIPTION
  246.                          "The BGP Identifier of local system."
  247.                     ::= { bgp 4 }
  248.  
  249.  
  250.  
  251.                -- BGP External Peer Table.  This table contains, one entry
  252.                -- per BGP peer external to the local AS, information about
  253.                -- the BGP peer connections.
  254.  
  255.                bgpExtPeerTable OBJECT-TYPE
  256.                     SYNTAX SEQUENCE OF BgpExtPeerEntry
  257.                     ACCESS not-accessible
  258.                     STATUS mandatory
  259.                     DESCRIPTION
  260.                          "External BGP peer table.  This table contains,
  261.                           one entry per BGP peer, information about the
  262.                           connections with BGP peers that are external to
  263.                           the local AS."
  264.                     ::= { bgp 3 }
  265.  
  266.                bgpExtPeerEntry OBJECT-TYPE
  267.                     SYNTAX BgpExtPeerEntry
  268.                     ACCESS not-accessible
  269.                     STATUS mandatory
  270.                     DESCRIPTION
  271.                          "Entry containing information about the connection
  272.                           with a BGP peer that is external to the local AS."
  273.                     INDEX { bgpExtPeerRemoteAddr }
  274.                     ::= { bgpExtPeerTable 1 }
  275.  
  276.                BgpExtPeerEntry ::= SEQUENCE {
  277.                     bgpExtPeerIdentifier
  278.                          IpAddress,
  279.                     bgpExtPeerState
  280.                          INTEGER,
  281.                     bgpExtPeerAdminStatus
  282.                          INTEGER,
  283.                     bgpExtPeerNegotiatedVersion
  284.                          INTEGER,
  285.                     bgpExtPeerLocalAddr
  286.                          IpAddress,
  287.                     bgpExtPeerLocalPort
  288.                          INTEGER,
  289.                     bgpExtPeerRemoteAddr
  290.  
  291.  
  292.  
  293. Expiration Date March 1994                              [Page 5]
  294.  
  295.  
  296.  
  297.  
  298.  
  299. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  300.  
  301.  
  302.                          IpAddress,
  303.                     bgpExtPeerRemotePort
  304.                          INTEGER,
  305.                     bgpExtPeerRemoteAs
  306.                          INTEGER,
  307.                     bgpExtPeerInUpdates
  308.                          Counter,
  309.                     bgpExtPeerOutUpdates
  310.                          Counter,
  311.                     bgpExtPeerInTotalMessages
  312.                          Counter,
  313.                     bgpExtPeerOutTotalMessages
  314.                          Counter,
  315.                     bgpExtPeerLastError
  316.                          OCTET STRING,
  317.                     bgpExtPeerFsmEstablishedTransitions
  318.                          Counter,
  319.                     bgpExtPeerConnectRetryInterval
  320.                          INTEGER,
  321.                     bgpExtPeerHoldTime
  322.                          INTEGER,
  323.                     bgpExtPeerKeepAlive
  324.                          INTEGER,
  325.                     bgpExtPeerHoldTimeConfigured
  326.                          INTEGER,
  327.                     bgpExtPeerKeepAliveConfigured
  328.                          INTEGER,
  329.                     bgpExtPeerMinASOriginationInterval
  330.                          INTEGER,
  331.                     bgpExtPeerMinRouteAdvertisementInterval
  332.                          INTEGER
  333.  
  334.                }
  335.  
  336.                bgpExtPeerIdentifier OBJECT-TYPE
  337.                     SYNTAX IpAddress
  338.                     ACCESS read-only
  339.                     STATUS mandatory
  340.                     DESCRIPTION
  341.                          "The BGP Identifier of this entry's BGP peer."
  342.                     ::= { bgpExtPeerEntry 1 }
  343.  
  344.                bgpExtPeerState OBJECT-TYPE
  345.                     SYNTAX INTEGER {
  346.                          idle(1),
  347.                          connect(2),
  348.                          active(3),
  349.                          opensent(4),
  350.  
  351.  
  352.  
  353. Expiration Date March 1994                              [Page 6]
  354.  
  355.  
  356.  
  357.  
  358.  
  359. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  360.  
  361.  
  362.                          openconfirm(5),
  363.                          established(6)
  364.                     }
  365.                     ACCESS read-only
  366.                     STATUS mandatory
  367.                     DESCRIPTION
  368.                          "The BGP peer connection state."
  369.                     ::= { bgpExtPeerEntry 2 }
  370.  
  371.                bgpExtPeerAdminStatus OBJECT-TYPE
  372.                     SYNTAX INTEGER {
  373.                          stop(1),
  374.                          start(2)
  375.                     }
  376.                     ACCESS read-write
  377.                     STATUS mandatory
  378.                     DESCRIPTION
  379.                          "The desired state of the BGP connection.  A
  380.                           transition from 'stop' to 'start' will cause
  381.                           the BGP Start Event to be generated.  A
  382.                           transition from 'start' to 'stop' will cause
  383.                           the BGP Stop Event to be generated.  This
  384.                           parameter can be used to restart BGP peer
  385.                           connections.  Care should be used in providing
  386.                           write access to this object without adequate
  387.                           authentication."
  388.                     ::= { bgpExtPeerEntry 3 }
  389.  
  390.                bgpExtPeerNegotiatedVersion OBJECT-TYPE
  391.                     SYNTAX INTEGER
  392.                     ACCESS read-only
  393.                     STATUS mandatory
  394.                     DESCRIPTION
  395.                          "The negotiated version of BGP running between
  396.                           the two peers."
  397.                     ::= { bgpExtPeerEntry 4 }
  398.  
  399.                bgpExtPeerLocalAddr OBJECT-TYPE
  400.                     SYNTAX IpAddress
  401.                     ACCESS read-only
  402.                     STATUS mandatory
  403.                     DESCRIPTION
  404.                          "The local IP address of this entry's BGP
  405.                           connection."
  406.                     ::= { bgpExtPeerEntry 5 }
  407.  
  408.                bgpExtPeerLocalPort OBJECT-TYPE
  409.                     SYNTAX INTEGER (0..65535)
  410.  
  411.  
  412.  
  413. Expiration Date March 1994                              [Page 7]
  414.  
  415.  
  416.  
  417.  
  418.  
  419. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  420.  
  421.  
  422.                     ACCESS read-only
  423.                     STATUS mandatory
  424.                     DESCRIPTION
  425.                          "The local port for the TCP connection between
  426.                           the BGP peers."
  427.                     ::= { bgpExtPeerEntry 6 }
  428.  
  429.                bgpExtPeerRemoteAddr OBJECT-TYPE
  430.                     SYNTAX IpAddress
  431.                     ACCESS read-only
  432.                     STATUS mandatory
  433.                     DESCRIPTION
  434.                          "The remote IP address of this entry's BGP
  435.                           peer."
  436.                     ::= { bgpExtPeerEntry 7 }
  437.  
  438.                bgpExtPeerRemotePort OBJECT-TYPE
  439.                     SYNTAX INTEGER (0..65535)
  440.                     ACCESS read-only
  441.                     STATUS mandatory
  442.                     DESCRIPTION
  443.                          "The remote port for the TCP connection between
  444.                           the BGP peers.  Note that the objects
  445.                           bgpExtPeerLocalAddr, bgpExtPeerLocalPort,
  446.                           bgpExtPeerRemoteAddr and bgpExtPeerRemotePort
  447.                           provide the appropriate reference to the standard
  448.                           MIB TCP connection table."
  449.                     ::= { bgpExtPeerEntry 8 }
  450.  
  451.                bgpExtPeerRemoteAs OBJECT-TYPE
  452.                     SYNTAX INTEGER (0..65535)
  453.                     ACCESS read-only
  454.                     STATUS mandatory
  455.                     DESCRIPTION
  456.                          "The remote autonomous system number."
  457.                     ::= { bgpExtPeerEntry 9 }
  458.  
  459.                bgpExtPeerInUpdates OBJECT-TYPE
  460.                     SYNTAX Counter
  461.                     ACCESS read-only
  462.                     STATUS mandatory
  463.                     DESCRIPTION
  464.                          "The number of BGP UPDATE messages received on
  465.                           this connection.  This object should be
  466.                           initialized to zero when the connection is
  467.                           established."
  468.                     ::= { bgpExtPeerEntry 10 }
  469.  
  470.  
  471.  
  472.  
  473. Expiration Date March 1994                              [Page 8]
  474.  
  475.  
  476.  
  477.  
  478.  
  479. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  480.  
  481.  
  482.                bgpExtPeerOutUpdates OBJECT-TYPE
  483.                     SYNTAX Counter
  484.                     ACCESS read-only
  485.                     STATUS mandatory
  486.                     DESCRIPTION
  487.                          "The number of BGP UPDATE messages received on
  488.                           this connection.  This object should be
  489.                           initialized to zero when the connection is
  490.                           established."
  491.                     ::= { bgpExtPeerEntry 11}
  492.  
  493.                bgpExtPeerInTotalMessages OBJECT-TYPE
  494.                     SYNTAX Counter
  495.                     ACCESS read-only
  496.                     STATUS mandatory
  497.                     DESCRIPTION
  498.                          "The total number of messages received from the
  499.                           remote peer on this connection.  This object
  500.                           should be initialized to zero when the
  501.                           connection is established."
  502.                     ::= { bgpExtPeerEntry 12 }
  503.  
  504.                bgpExtPeerOutTotalMessages OBJECT-TYPE
  505.                     SYNTAX Counter
  506.                     ACCESS read-only
  507.                     STATUS mandatory
  508.                     DESCRIPTION
  509.                          "The total number of messages transmitted to
  510.                           the remote peer on this connection.  This object
  511.                           should be initialized to zero when the
  512.                           connection is established."
  513.                     ::= { bgpExtPeerEntry 13 }
  514.  
  515.                bgpExtPeerLastError OBJECT-TYPE
  516.                     SYNTAX OCTET STRING (SIZE (2))
  517.                     ACCESS read-only
  518.                     STATUS mandatory
  519.                     DESCRIPTION
  520.                          "The last error code and subcode seen by this
  521.                           peer on this connection.  If no error has
  522.                           occurred, this field is zero.  Otherwise, the
  523.                           first byte of this two byte OCTET STRING
  524.                           contains the error code, and the second byte
  525.                           contains the subcode."
  526.                     ::= { bgpExtPeerEntry 14 }
  527.  
  528.                bgpExtPeerFsmEstablishedTransitions OBJECT-TYPE
  529.                     SYNTAX Counter
  530.  
  531.  
  532.  
  533. Expiration Date March 1994                              [Page 9]
  534.  
  535.  
  536.  
  537.  
  538.  
  539. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  540.  
  541.  
  542.                     ACCESS read-only
  543.                     STATUS mandatory
  544.                     DESCRIPTION
  545.                          "The total number of times the BGP FSM
  546.                           transitioned into the established state."
  547.                     ::= { bgpExtPeerEntry 15 }
  548.  
  549.                bgpExtPeerConnectRetryInterval OBJECT-TYPE
  550.                     SYNTAX INTEGER (1..65535)
  551.                     ACCESS read-write
  552.                     STATUS mandatory
  553.                     DESCRIPTION
  554.                         "Time interval in seconds for the ConnectRetry timer.
  555.                          The suggested value for this timer is 120 seconds."
  556.                     ::= { bgpExtPeerEntry 16 }
  557.  
  558.                bgpExtPeerHoldTime OBJECT-TYPE
  559.                     SYNTAX INTEGER  ( 0 | 3..65535 )
  560.                     ACCESS read-only
  561.                     STATUS mandatory
  562.                     DESCRIPTION
  563.                          "Time interval in seconds for the Hold Timer
  564.                           established with the peer.  The value of this
  565.                           object is calculated by this BGP speaker by
  566.                           using the smaller of the value in
  567.                           bgpExtPeerHoldTimeConfigured and the Hold Time
  568.                           received in the OPEN message.  This value
  569.                           must be at lease three seconds if it is not
  570.                           zero (0) in which case the Hold Timer has
  571.                           not been established with the peer, or, the
  572.                           value of bgpExtPeerHoldTimeConfigured is zero (0)."
  573.                     ::= { bgpExtPeerEntry 17 }
  574.  
  575.                bgpExtPeerKeepAlive OBJECT-TYPE
  576.                     SYNTAX INTEGER ( 0 | 1..21845 )
  577.                     ACCESS read-only
  578.                     STATUS mandatory
  579.                     DESCRIPTION
  580.                          "Time interval in seconds for the KeepAlive
  581.                           timer established with the peer.  The value of
  582.                           this object is calculated by this BGP speaker
  583.                           such that, when compared with bgpExtPeerHoldTime,
  584.                           it has the same proportion as what
  585.                           bgpExtPeerKeepAliveConfigured has when compared
  586.                           with bgpExtPeerHoldTimeConfigured.  If the value
  587.                           of this object is zero (0), it indicates that
  588.                           the KeepAlive timer has not been established
  589.                           with the peer, or, the value of
  590.  
  591.  
  592.  
  593. Expiration Date March 1994                             [Page 10]
  594.  
  595.  
  596.  
  597.  
  598.  
  599. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  600.  
  601.  
  602.                           bgpExtPeerKeepAliveConfigured is zero (0)."
  603.                     ::= { bgpExtPeerEntry 18 }
  604.  
  605.                bgpExtPeerHoldTimeConfigured OBJECT-TYPE
  606.                     SYNTAX INTEGER ( 0 | 3..65535 )
  607.                     ACCESS read-write
  608.                     STATUS mandatory
  609.                     DESCRIPTION
  610.                         "Time interval in seconds for the Hold Time
  611.                          configured for this BGP speaker with this peer.
  612.                          This value is placed in an OPEN message sent to
  613.                          this peer by this BGP speaker, and is compared
  614.                          with the Hold Time field in an OPEN message
  615.                          received from the peer when determining the Hold
  616.                          Time (bgpExtPeerHoldTime) with the peer.  This value
  617.                          must not be less than three seconds if it is not
  618.                          zero (0) in which case the Hold Time is NOT to be
  619.                          established with the peer.  The suggested value for
  620.                          this timer is 90 seconds."
  621.                     ::= { bgpExtPeerEntry 19 }
  622.  
  623.                bgpExtPeerKeepAliveConfigured OBJECT-TYPE
  624.                     SYNTAX INTEGER ( 0 | 1..21845 )
  625.                     ACCESS read-write
  626.                     STATUS mandatory
  627.                     DESCRIPTION
  628.                         "Time interval in seconds for the KeepAlive timer
  629.                          configured for this BGP speaker with this peer.
  630.                          The value of this object will only determine the
  631.                          KEEPALIVE messages' frequency relative to the value
  632.                          specified in bgpExtPeerHoldTimeConfigured; the actual
  633.                          time interval for the KEEPALIVE messages is
  634.                          indicated by bgpExtPeerKeepAlive.  A reasonable maximum
  635.                          value for this timer would be configured to be one
  636.                          third of that of bgpExtPeerHoldTimeConfigured.
  637.                          If the value of this object is zero (0), no
  638.                          periodical KEEPALIVE messages are sent to the peer
  639.                          after the BGP connection has been established.  The
  640.                          suggested value for this timer is 30 seconds."
  641.                     ::= { bgpExtPeerEntry 20 }
  642.  
  643.                bgpExtPeerMinASOriginationInterval OBJECT-TYPE
  644.                     SYNTAX INTEGER (1..65535)
  645.                     ACCESS read-write
  646.                     STATUS mandatory
  647.                     DESCRIPTION
  648.                         "Time interval in seconds for the
  649.                          MinASOriginationInterval timer.
  650.  
  651.  
  652.  
  653. Expiration Date March 1994                             [Page 11]
  654.  
  655.  
  656.  
  657.  
  658.  
  659. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  660.  
  661.  
  662.                          The suggested value for this timer is 900 seconds."
  663.                     ::= { bgpExtPeerEntry 21 }
  664.  
  665.                bgpExtPeerMinRouteAdvertisementInterval OBJECT-TYPE
  666.                     SYNTAX INTEGER (1..65535)
  667.                     ACCESS read-write
  668.                     STATUS mandatory
  669.                     DESCRIPTION
  670.                         "Time interval in seconds for the
  671.                          MinRouteAdvertisementInterval timer.
  672.                          The suggested value for this timer is 30 seconds."
  673.                     ::= { bgpExtPeerEntry 22 }
  674.  
  675.  
  676.  
  677.                -- BGP Internal Peer Table.  This table contains, one entry
  678.                -- per BGP peer internal to the local AS, information about
  679.                -- the BGP peer connections.
  680.  
  681.                bgpIntPeerTable OBJECT-TYPE
  682.                     SYNTAX SEQUENCE OF BgpIntPeerEntry
  683.                     ACCESS not-accessible
  684.                     STATUS mandatory
  685.                     DESCRIPTION
  686.                          "Internal BGP peer table.  This table contains,
  687.                           one entry per BGP peer, information about the
  688.                           connections with BGP peers that are internal to
  689.                           the local AS."
  690.                     ::= { bgp 7 }
  691.  
  692.                bgpIntPeerEntry OBJECT-TYPE
  693.                     SYNTAX BgpIntPeerEntry
  694.                     ACCESS not-accessible
  695.                     STATUS mandatory
  696.                     DESCRIPTION
  697.                          "Entry containing information about the connection
  698.                           with a BGP peer that is internal to the local AS."
  699.                     INDEX { bgpIntPeerRemoteAddr }
  700.                     ::= { bgpIntPeerTable 1 }
  701.  
  702.                BgpIntPeerEntry ::= SEQUENCE {
  703.                     bgpIntPeerIdentifier
  704.                          IpAddress,
  705.                     bgpIntPeerState
  706.                          INTEGER,
  707.                     bgpIntPeerAdminStatus
  708.                          INTEGER,
  709.                     bgpIntPeerNegotiatedVersion
  710.  
  711.  
  712.  
  713. Expiration Date March 1994                             [Page 12]
  714.  
  715.  
  716.  
  717.  
  718.  
  719. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  720.  
  721.  
  722.                          INTEGER,
  723.                     bgpIntPeerLocalAddr
  724.                          IpAddress,
  725.                     bgpIntPeerLocalPort
  726.                          INTEGER,
  727.                     bgpIntPeerRemoteAddr
  728.                          IpAddress,
  729.                     bgpIntPeerRemotePort
  730.                          INTEGER,
  731.                     bgpIntPeerRemoteAs
  732.                          INTEGER,
  733.                     bgpIntPeerInUpdates
  734.                          Counter,
  735.                     bgpIntPeerOutUpdates
  736.                          Counter,
  737.                     bgpIntPeerInTotalMessages
  738.                          Counter,
  739.                     bgpIntPeerOutTotalMessages
  740.                          Counter,
  741.                     bgpIntPeerLastError
  742.                          OCTET STRING,
  743.                     bgpIntPeerFsmEstablishedTransitions
  744.                          Counter,
  745.                     bgpIntPeerConnectRetryInterval
  746.                          INTEGER,
  747.                     bgpIntPeerHoldTime
  748.                          INTEGER,
  749.                     bgpIntPeerKeepAlive
  750.                          INTEGER,
  751.                     bgpIntPeerHoldTimeConfigured
  752.                          INTEGER,
  753.                     bgpIntPeerKeepAliveConfigured
  754.                          INTEGER,
  755.                     bgpIntPeerMinASOriginationInterval
  756.                          INTEGER,
  757.                     bgpIntPeerMinRouteAdvertisementInterval
  758.                          INTEGER
  759.  
  760.                }
  761.  
  762.                bgpIntPeerIdentifier OBJECT-TYPE
  763.                     SYNTAX IpAddress
  764.                     ACCESS read-only
  765.                     STATUS mandatory
  766.                     DESCRIPTION
  767.                          "The BGP Identifier of this entry's BGP peer."
  768.                     ::= { bgpIntPeerEntry 1 }
  769.  
  770.  
  771.  
  772.  
  773. Expiration Date March 1994                             [Page 13]
  774.  
  775.  
  776.  
  777.  
  778.  
  779. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  780.  
  781.  
  782.                bgpIntPeerState OBJECT-TYPE
  783.                     SYNTAX INTEGER {
  784.                          idle(1),
  785.                          connect(2),
  786.                          active(3),
  787.                          opensent(4),
  788.                          openconfirm(5),
  789.                          established(6)
  790.                     }
  791.                     ACCESS read-only
  792.                     STATUS mandatory
  793.                     DESCRIPTION
  794.                          "The BGP peer connection state."
  795.                     ::= { bgpIntPeerEntry 2 }
  796.  
  797.                bgpIntPeerAdminStatus OBJECT-TYPE
  798.                     SYNTAX INTEGER {
  799.                          stop(1),
  800.                          start(2)
  801.                     }
  802.                     ACCESS read-write
  803.                     STATUS mandatory
  804.                     DESCRIPTION
  805.                          "The desired state of the BGP connection.  A
  806.                           transition from 'stop' to 'start' will cause
  807.                           the BGP Start Event to be generated.  A
  808.                           transition from 'start' to 'stop' will cause
  809.                           the BGP Stop Event to be generated.  This
  810.                           parameter can be used to restart BGP peer
  811.                           connections.  Care should be used in providing
  812.                           write access to this object without adequate
  813.                           authentication."
  814.                     ::= { bgpIntPeerEntry 3 }
  815.  
  816.                bgpIntPeerNegotiatedVersion OBJECT-TYPE
  817.                     SYNTAX INTEGER
  818.                     ACCESS read-only
  819.                     STATUS mandatory
  820.                     DESCRIPTION
  821.                          "The negotiated version of BGP running between
  822.                           the two peers."
  823.                     ::= { bgpIntPeerEntry 4 }
  824.  
  825.                bgpIntPeerLocalAddr OBJECT-TYPE
  826.                     SYNTAX IpAddress
  827.                     ACCESS read-only
  828.                     STATUS mandatory
  829.                     DESCRIPTION
  830.  
  831.  
  832.  
  833. Expiration Date March 1994                             [Page 14]
  834.  
  835.  
  836.  
  837.  
  838.  
  839. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  840.  
  841.  
  842.                          "The local IP address of this entry's BGP
  843.                           connection."
  844.                     ::= { bgpIntPeerEntry 5 }
  845.  
  846.                bgpIntPeerLocalPort OBJECT-TYPE
  847.                     SYNTAX INTEGER (0..65535)
  848.                     ACCESS read-only
  849.                     STATUS mandatory
  850.                     DESCRIPTION
  851.                          "The local port for the TCP connection between
  852.                           the BGP peers."
  853.                     ::= { bgpIntPeerEntry 6 }
  854.  
  855.                bgpIntPeerRemoteAddr OBJECT-TYPE
  856.                     SYNTAX IpAddress
  857.                     ACCESS read-only
  858.                     STATUS mandatory
  859.                     DESCRIPTION
  860.                          "The remote IP address of this entry's BGP
  861.                           peer."
  862.                     ::= { bgpIntPeerEntry 7 }
  863.  
  864.                bgpIntPeerRemotePort OBJECT-TYPE
  865.                     SYNTAX INTEGER (0..65535)
  866.                     ACCESS read-only
  867.                     STATUS mandatory
  868.                     DESCRIPTION
  869.                          "The remote port for the TCP connection between
  870.                           the BGP peers.  Note that the objects
  871.                           bgpIntPeerLocalAddr, bgpIntPeerLocalPort,
  872.                           bgpIntPeerRemoteAddr and bgpIntPeerRemotePort
  873.                           provide the appropriate reference to the standard
  874.                           MIB TCP connection table."
  875.                     ::= { bgpIntPeerEntry 8 }
  876.  
  877.                bgpIntPeerRemoteAs OBJECT-TYPE
  878.                     SYNTAX INTEGER (0..65535)
  879.                     ACCESS read-only
  880.                     STATUS mandatory
  881.                     DESCRIPTION
  882.                          "The remote autonomous system number."
  883.                     ::= { bgpIntPeerEntry 9 }
  884.  
  885.                bgpIntPeerInUpdates OBJECT-TYPE
  886.                     SYNTAX Counter
  887.                     ACCESS read-only
  888.                     STATUS mandatory
  889.                     DESCRIPTION
  890.  
  891.  
  892.  
  893. Expiration Date March 1994                             [Page 15]
  894.  
  895.  
  896.  
  897.  
  898.  
  899. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  900.  
  901.  
  902.                          "The number of BGP UPDATE messages received on
  903.                           this connection.  This object should be
  904.                           initialized to zero when the connection is
  905.                           established."
  906.                     ::= { bgpIntPeerEntry 10 }
  907.  
  908.                bgpIntPeerOutUpdates OBJECT-TYPE
  909.                     SYNTAX Counter
  910.                     ACCESS read-only
  911.                     STATUS mandatory
  912.                     DESCRIPTION
  913.                          "The number of BGP UPDATE messages received on
  914.                           this connection.  This object should be
  915.                           initialized to zero when the connection is
  916.                           established."
  917.                     ::= { bgpIntPeerEntry 11}
  918.  
  919.                bgpIntPeerInTotalMessages OBJECT-TYPE
  920.                     SYNTAX Counter
  921.                     ACCESS read-only
  922.                     STATUS mandatory
  923.                     DESCRIPTION
  924.                          "The total number of messages received from the
  925.                           remote peer on this connection.  This object
  926.                           should be initialized to zero when the
  927.                           connection is established."
  928.                     ::= { bgpIntPeerEntry 12 }
  929.  
  930.                bgpIntPeerOutTotalMessages OBJECT-TYPE
  931.                     SYNTAX Counter
  932.                     ACCESS read-only
  933.                     STATUS mandatory
  934.                     DESCRIPTION
  935.                          "The total number of messages transmitted to
  936.                           the remote peer on this connection.  This object
  937.                           should be initialized to zero when the
  938.                           connection is established."
  939.                     ::= { bgpIntPeerEntry 13 }
  940.  
  941.                bgpIntPeerLastError OBJECT-TYPE
  942.                     SYNTAX OCTET STRING (SIZE (2))
  943.                     ACCESS read-only
  944.                     STATUS mandatory
  945.                     DESCRIPTION
  946.                          "The last error code and subcode seen by this
  947.                           peer on this connection.  If no error has
  948.                           occurred, this field is zero.  Otherwise, the
  949.                           first byte of this two byte OCTET STRING
  950.  
  951.  
  952.  
  953. Expiration Date March 1994                             [Page 16]
  954.  
  955.  
  956.  
  957.  
  958.  
  959. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  960.  
  961.  
  962.                           contains the error code, and the second byte
  963.                           contains the subcode."
  964.                     ::= { bgpIntPeerEntry 14 }
  965.  
  966.                bgpIntPeerFsmEstablishedTransitions OBJECT-TYPE
  967.                     SYNTAX Counter
  968.                     ACCESS read-only
  969.                     STATUS mandatory
  970.                     DESCRIPTION
  971.                          "The total number of times the BGP FSM
  972.                           transitioned into the established state."
  973.                     ::= { bgpIntPeerEntry 15 }
  974.  
  975.                bgpIntPeerConnectRetryInterval OBJECT-TYPE
  976.                     SYNTAX INTEGER (1..65535)
  977.                     ACCESS read-write
  978.                     STATUS mandatory
  979.                     DESCRIPTION
  980.                         "Time interval in seconds for the ConnectRetry timer.
  981.                          The suggested value for this timer is 120 seconds."
  982.                     ::= { bgpIntPeerEntry 16 }
  983.  
  984.                bgpIntPeerHoldTime OBJECT-TYPE
  985.                     SYNTAX INTEGER  ( 0 | 3..65535 )
  986.                     ACCESS read-only
  987.                     STATUS mandatory
  988.                     DESCRIPTION
  989.                          "Time interval in seconds for the Hold Timer
  990.                           established with the peer.  The value of this
  991.                           object is calculated by this BGP speaker by
  992.                           using the smaller of the value in
  993.                           bgpIntPeerHoldTimeConfigured and the Hold Time
  994.                           received in the OPEN message.  This value
  995.                           must be at lease three seconds if it is not
  996.                           zero (0) in which case the Hold Timer has
  997.                           not been established with the peer, or, the
  998.                           value of bgpIntPeerHoldTimeConfigured is zero (0)."
  999.                     ::= { bgpIntPeerEntry 17 }
  1000.  
  1001.                bgpIntPeerKeepAlive OBJECT-TYPE
  1002.                     SYNTAX INTEGER ( 0 | 1..21845 )
  1003.                     ACCESS read-only
  1004.                     STATUS mandatory
  1005.                     DESCRIPTION
  1006.                          "Time interval in seconds for the KeepAlive
  1007.                           timer established with the peer.  The value of
  1008.                           this object is calculated by this BGP speaker
  1009.                           such that, when compared with bgpIntPeerHoldTime,
  1010.  
  1011.  
  1012.  
  1013. Expiration Date March 1994                             [Page 17]
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  1020.  
  1021.  
  1022.                           it has the same proportion as what
  1023.                           bgpIntPeerKeepAliveConfigured has when compared
  1024.                           with bgpIntPeerHoldTimeConfigured.  If the value
  1025.                           of this object is zero (0), it indicates that
  1026.                           the KeepAlive timer has not been established
  1027.                           with the peer, or, the value of
  1028.                           bgpIntPeerKeepAliveConfigured is zero (0)."
  1029.                     ::= { bgpIntPeerEntry 18 }
  1030.  
  1031.                bgpIntPeerHoldTimeConfigured OBJECT-TYPE
  1032.                     SYNTAX INTEGER ( 0 | 3..65535 )
  1033.                     ACCESS read-write
  1034.                     STATUS mandatory
  1035.                     DESCRIPTION
  1036.                         "Time interval in seconds for the Hold Time
  1037.                          configured for this BGP speaker with this peer.
  1038.                          This value is placed in an OPEN message sent to
  1039.                          this peer by this BGP speaker, and is compared
  1040.                          with the Hold Time field in an OPEN message
  1041.                          received from the peer when determining the Hold
  1042.                          Time (bgpIntPeerHoldTime) with the peer.  This value
  1043.                          must not be less than three seconds if it is not
  1044.                          zero (0) in which case the Hold Time is NOT to be
  1045.                          established with the peer.  The suggested value for
  1046.                          this timer is 90 seconds."
  1047.                     ::= { bgpIntPeerEntry 19 }
  1048.  
  1049.                bgpIntPeerKeepAliveConfigured OBJECT-TYPE
  1050.                     SYNTAX INTEGER ( 0 | 1..21845 )
  1051.                     ACCESS read-write
  1052.                     STATUS mandatory
  1053.                     DESCRIPTION
  1054.                         "Time interval in seconds for the KeepAlive timer
  1055.                          configured for this BGP speaker with this peer.
  1056.                          The value of this object will only determine the
  1057.                          KEEPALIVE messages' frequency relative to the value
  1058.                          specified in bgpIntPeerHoldTimeConfigured; the actual
  1059.                          time interval for the KEEPALIVE messages is
  1060.                          indicated by bgpIntPeerKeepAlive.  A reasonable maximum
  1061.                          value for this timer would be configured to be one
  1062.                          third of that of bgpIntPeerHoldTimeConfigured.
  1063.                          If the value of this object is zero (0), no
  1064.                          periodical KEEPALIVE messages are sent to the peer
  1065.                          after the BGP connection has been established.  The
  1066.                          suggested value for this timer is 30 seconds."
  1067.                     ::= { bgpIntPeerEntry 20 }
  1068.  
  1069.                bgpIntPeerMinASOriginationInterval OBJECT-TYPE
  1070.  
  1071.  
  1072.  
  1073. Expiration Date March 1994                             [Page 18]
  1074.  
  1075.  
  1076.  
  1077.  
  1078.  
  1079. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  1080.  
  1081.  
  1082.                     SYNTAX INTEGER (1..65535)
  1083.                     ACCESS read-write
  1084.                     STATUS mandatory
  1085.                     DESCRIPTION
  1086.                         "Time interval in seconds for the
  1087.                          MinASOriginationInterval timer.
  1088.                          The suggested value for this timer is 900 seconds."
  1089.                     ::= { bgpIntPeerEntry 21 }
  1090.  
  1091.                bgpIntPeerMinRouteAdvertisementInterval OBJECT-TYPE
  1092.                     SYNTAX INTEGER (1..65535)
  1093.                     ACCESS read-write
  1094.                     STATUS mandatory
  1095.                     DESCRIPTION
  1096.                         "Time interval in seconds for the
  1097.                          MinRouteAdvertisementInterval timer.
  1098.                          The suggested value for this timer is 30 seconds."
  1099.                     ::= { bgpIntPeerEntry 22 }
  1100.  
  1101.  
  1102.  
  1103.                -- Received Path Attribute Table.  This table contains,
  1104.                -- one entry per path to a network, path attributes
  1105.                -- received from all peers running BGP version 3 or less.
  1106.  
  1107.                bgpRcvdPathAttrTable OBJECT-TYPE
  1108.                     SYNTAX SEQUENCE OF BgpPathAttrEntry
  1109.                     ACCESS not-accessible
  1110.                     STATUS mandatory
  1111.                     DESCRIPTION
  1112.                          "The BGP Received Path Attribute Table contains
  1113.                           information about paths to destination networks
  1114.                           received from all peers running BGP version 3 or
  1115.                           less."
  1116.                     ::= { bgp 5 }
  1117.  
  1118.                bgpPathAttrEntry OBJECT-TYPE
  1119.                     SYNTAX BgpPathAttrEntry
  1120.                     ACCESS not-accessible
  1121.                     STATUS mandatory
  1122.                     DESCRIPTION
  1123.                          "Information about a path to a network."
  1124.                     INDEX { bgpPathAttrDestNetwork,
  1125.                             bgpPathAttrPeer        }
  1126.                     ::= { bgpRcvdPathAttrTable 1 }
  1127.  
  1128.                BgpPathAttrEntry ::= SEQUENCE {
  1129.                     bgpPathAttrPeer
  1130.  
  1131.  
  1132.  
  1133. Expiration Date March 1994                             [Page 19]
  1134.  
  1135.  
  1136.  
  1137.  
  1138.  
  1139. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  1140.  
  1141.  
  1142.                          IpAddress,
  1143.                     bgpPathAttrDestNetwork
  1144.                          IpAddress,
  1145.                     bgpPathAttrOrigin
  1146.                          INTEGER,
  1147.                     bgpPathAttrASPath
  1148.                          OCTET STRING,
  1149.                     bgpPathAttrNextHop
  1150.                          IpAddress,
  1151.                     bgpPathAttrInterASMetric
  1152.                          INTEGER
  1153.                }
  1154.  
  1155.                bgpPathAttrPeer OBJECT-TYPE
  1156.                     SYNTAX IpAddress
  1157.                     ACCESS read-only
  1158.                     STATUS mandatory
  1159.                     DESCRIPTION
  1160.                          "The IP address of the peer where the path
  1161.                           information was learned."
  1162.                     ::= { bgpPathAttrEntry 1 }
  1163.  
  1164.                bgpPathAttrDestNetwork OBJECT-TYPE
  1165.                     SYNTAX IpAddress
  1166.                     ACCESS read-only
  1167.                     STATUS mandatory
  1168.                     DESCRIPTION
  1169.                          "The address of the destination network."
  1170.                     ::= { bgpPathAttrEntry 2 }
  1171.  
  1172.                bgpPathAttrOrigin OBJECT-TYPE
  1173.                     SYNTAX INTEGER {
  1174.                          igp(1),-- networks are interior
  1175.                          egp(2),-- networks learned via EGP
  1176.                          incomplete(3) -- undetermined
  1177.                     }
  1178.                     ACCESS read-only
  1179.                     STATUS mandatory
  1180.                     DESCRIPTION
  1181.                          "The ultimate origin of the path information."
  1182.                     ::= { bgpPathAttrEntry 3 }
  1183.  
  1184.                bgpPathAttrASPath OBJECT-TYPE
  1185.                     SYNTAX OCTET STRING
  1186.                     ACCESS read-only
  1187.                     STATUS mandatory
  1188.                     DESCRIPTION
  1189.                          "The set of ASs that must be traversed to reach
  1190.  
  1191.  
  1192.  
  1193. Expiration Date March 1994                             [Page 20]
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  1200.  
  1201.  
  1202.                           the network.  This object is probably best
  1203.                           represented as SEQUENCE OF INTEGER.  For SMI
  1204.                           compatibility, though, it is represented as
  1205.                           OCTET STRING.  Each AS is represented as a pair
  1206.                           of octets according to the following algorithm:
  1207.  
  1208.                               first-byte-of-pair = ASNumber / 256;
  1209.                               second-byte-of-pair = ASNumber & 255;"
  1210.                     ::= { bgpPathAttrEntry 4 }
  1211.  
  1212.                bgpPathAttrNextHop OBJECT-TYPE
  1213.                     SYNTAX IpAddress
  1214.                     ACCESS read-only
  1215.                     STATUS mandatory
  1216.                     DESCRIPTION
  1217.                          "The address of the border router that should
  1218.                           be used for the destination network."
  1219.                     ::= { bgpPathAttrEntry 5 }
  1220.  
  1221.                bgpPathAttrInterASMetric OBJECT-TYPE
  1222.                     SYNTAX INTEGER
  1223.                     ACCESS read-only
  1224.                     STATUS mandatory
  1225.                     DESCRIPTION
  1226.                          "The optional inter-AS metric.  If this
  1227.                           attribute has not been provided for this route,
  1228.                           the value for this object is 0."
  1229.                     ::= { bgpPathAttrEntry 6 }
  1230.  
  1231.  
  1232.  
  1233.                -- BGP-4 Received Path Attribute Table.  This table contains,
  1234.                -- one entry per path to a network, path attributes
  1235.                -- received from all peers running BGP-4.
  1236.  
  1237.                bgp4RcvdPathAttrTable OBJECT-TYPE
  1238.                     SYNTAX SEQUENCE OF Bgp4PathAttrEntry
  1239.                     ACCESS not-accessible
  1240.                     STATUS mandatory
  1241.                     DESCRIPTION
  1242.                          "The BGP-4 Received Path Attribute Table contains
  1243.                           information about paths to destination networks
  1244.                           received by all BGP4 peers."
  1245.                     ::= { bgp 6 }
  1246.  
  1247.                bgp4PathAttrEntry OBJECT-TYPE
  1248.                     SYNTAX Bgp4PathAttrEntry
  1249.                     ACCESS not-accessible
  1250.  
  1251.  
  1252.  
  1253. Expiration Date March 1994                             [Page 21]
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  1260.  
  1261.  
  1262.                     STATUS mandatory
  1263.                     DESCRIPTION
  1264.                          "Information about a path to a network."
  1265.                     INDEX { bgp4PathAttrPeer,
  1266.                             bgp4PathAttrIpAddrPrefixLen,
  1267.                             bgp4PathAttrIpAddrPrefix    }
  1268.                     ::= { bgp4RcvdPathAttrTable 1 }
  1269.  
  1270.                Bgp4PathAttrEntry ::= SEQUENCE {
  1271.                     bgp4PathAttrPeer
  1272.                          IpAddress,
  1273.                     bgp4PathAttrIpAddrPrefixLen
  1274.                          INTEGER,
  1275.                     bgp4PathAttrIpAddrPrefix
  1276.                          OCTET STRING,
  1277.                     bgp4PathAttrOrigin
  1278.                          INTEGER,
  1279.                     bgp4PathAttrASPathSegment
  1280.                          OCTET STRING,
  1281.                     bgp4PathAttrNextHop
  1282.                          IpAddress,
  1283.                     bgp4PathAttrMultiExitDisc
  1284.                          INTEGER,
  1285.                     bgp4PathAttrLocalPref
  1286.                          INTEGER,
  1287.                     bgp4PathAttrAtomicAggregate
  1288.                          INTEGER,
  1289.                     bgp4PathAttrAggregator
  1290.                          INTEGER
  1291.                }
  1292.  
  1293.                bgp4PathAttrPeer OBJECT-TYPE
  1294.                     SYNTAX IpAddress
  1295.                     ACCESS read-only
  1296.                     STATUS mandatory
  1297.                     DESCRIPTION
  1298.                          "The IP address of the peer where the path
  1299.                           information was learned."
  1300.                     ::= { bgp4PathAttrEntry 1 }
  1301.  
  1302.                bgp4PathAttrIpAddrPrefixLen OBJECT-TYPE
  1303.                     SYNTAX INTEGER (0..255)
  1304.                     ACCESS read-only
  1305.                     STATUS mandatory
  1306.                     DESCRIPTION
  1307.                          "Length in bits of the IP address prefix in the
  1308.                           Network Layer Reachability Information field."
  1309.                     ::= { bgp4PathAttrEntry 2 }
  1310.  
  1311.  
  1312.  
  1313. Expiration Date March 1994                             [Page 22]
  1314.  
  1315.  
  1316.  
  1317.  
  1318.  
  1319. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  1320.  
  1321.  
  1322.                bgp4PathAttrIpAddrPrefix OBJECT-TYPE
  1323.                     SYNTAX OCTET STRING
  1324.                     ACCESS read-only
  1325.                     STATUS mandatory
  1326.                     DESCRIPTION
  1327.                          "An IP address prefix in the Network Layer
  1328.                           Reachability Information field.  This string
  1329.                           contains as many octets as necessary to hold
  1330.                           a prefix of the length specified by
  1331.                           bgp4PathAttrIpAddrPrefixLen.  Any bits
  1332.                           beyond the length specified by
  1333.                           bgp4PathAttrIpAddrPrefixLen are zeroed."
  1334.                     ::= { bgp4PathAttrEntry 3 }
  1335.  
  1336.                bgp4PathAttrOrigin OBJECT-TYPE
  1337.                     SYNTAX INTEGER {
  1338.                          igp(1),-- networks are interior
  1339.                          egp(2),-- networks learned via EGP
  1340.                          incomplete(3) -- undetermined
  1341.                     }
  1342.                     ACCESS read-only
  1343.                     STATUS mandatory
  1344.                     DESCRIPTION
  1345.                          "The ultimate origin of the path
  1346.                           information."
  1347.                     ::= { bgp4PathAttrEntry 4 }
  1348.  
  1349.                bgp4PathAttrASPathSegment OBJECT-TYPE
  1350.                     SYNTAX OCTET STRING
  1351.                     ACCESS read-only
  1352.                     STATUS mandatory
  1353.                     DESCRIPTION
  1354.                          "The sequence of AS path segments.  Each AS
  1355.                           path segment is represented by a triple
  1356.                           <type, length, value>.
  1357.  
  1358.                           The type is a 1-octet field which has two
  1359.                           possible values:
  1360.                               1      AS_SET: unordered set of ASs a
  1361.                                           route in the UPDATE message
  1362.                                           has traversed
  1363.                               2      AS_SEQUENCE: ordered set of ASs
  1364.                                           a route in the UPDATE message
  1365.                                           has traversed.
  1366.  
  1367.                           The length is a 1-octet field containing the
  1368.                           number of ASs in the value field.
  1369.  
  1370.  
  1371.  
  1372.  
  1373. Expiration Date March 1994                             [Page 23]
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  1380.  
  1381.  
  1382.                           The value field contains one or more AS
  1383.                           numbers, each AS is represented in the octet
  1384.                           string as a pair of octets according to the
  1385.                           following algorithm:
  1386.  
  1387.                                first-byte-of-pair = ASNumber / 256;
  1388.                                second-byte-of-pair = ASNumber & 255;"
  1389.                     ::= { bgp4PathAttrEntry 5 }
  1390.  
  1391.                bgp4PathAttrNextHop OBJECT-TYPE
  1392.                     SYNTAX IpAddress
  1393.                     ACCESS read-only
  1394.                     STATUS mandatory
  1395.                     DESCRIPTION
  1396.                          "The address of the border router that should
  1397.                           be used for the destination network."
  1398.                     ::= { bgp4PathAttrEntry 6 }
  1399.  
  1400.                 bgp4PathAttrMultiExitDisc OBJECT-TYPE
  1401.                     SYNTAX INTEGER (0..255)
  1402.                     ACCESS read-only
  1403.                     STATUS mandatory
  1404.                     DESCRIPTION
  1405.                          "This metric is used to discriminate between
  1406.                           multiple exit points to an adjacent autonomous
  1407.                           system."
  1408.                     ::= { bgp4PathAttrEntry 7 }
  1409.  
  1410.                bgp4PathAttrLocalPref OBJECT-TYPE
  1411.                     SYNTAX INTEGER (0..255)
  1412.                     ACCESS read-only
  1413.                     STATUS mandatory
  1414.                     DESCRIPTION
  1415.                          "The originating BGP4 speaker's degree of
  1416.                           preference for an advertised route."
  1417.                     ::= { bgp4PathAttrEntry 8 }
  1418.  
  1419.                bgp4PathAttrAtomicAggregate OBJECT-TYPE
  1420.                     SYNTAX INTEGER {
  1421.                          less-specific-route-not-selected(1),
  1422.                          less-specific-route-selected(2)
  1423.                     }
  1424.                     ACCESS read-only
  1425.                     STATUS mandatory
  1426.                     DESCRIPTION
  1427.                          "Whether or not the local system has selected
  1428.                           a less specific route without selecting a
  1429.                           more specific route."
  1430.  
  1431.  
  1432.  
  1433. Expiration Date March 1994                             [Page 24]
  1434.  
  1435.  
  1436.  
  1437.  
  1438.  
  1439. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  1440.  
  1441.  
  1442.                     ::= { bgp4PathAttrEntry 9 }
  1443.  
  1444.                bgp4PathAttrAggregator OBJECT-TYPE
  1445.                     SYNTAX INTEGER (0..65535)
  1446.                     ACCESS read-only
  1447.                     STATUS mandatory
  1448.                     DESCRIPTION
  1449.                         "The AS number of the last BGP4 speaker that
  1450.                          performed route aggregation."
  1451.                     ::= { bgp4PathAttrEntry 10 }
  1452.  
  1453.  
  1454.                -- Traps.
  1455.  
  1456.                bgpEstablished TRAP-TYPE
  1457.                     ENTERPRISE { bgp }
  1458.                     VARIABLES  { bgpExtPeerRemoteAddr,
  1459.                                  bgpExtPeerLastError,
  1460.                                  bgpExtPeerState,
  1461.                                  bgpIntPeerRemoteAddr,
  1462.                                  bgpIntPeerLastError,
  1463.                                  bgpIntPeerState      }
  1464.                     DESCRIPTION
  1465.                          "The BGP Established event is generated when
  1466.                           the BGP FSM enters the ESTABLISHED state."
  1467.                     ::= 1
  1468.  
  1469.                bgpBackwardTransition TRAP-TYPE
  1470.                     ENTERPRISE { bgp }
  1471.                     VARIABLES  { bgpExtPeerRemoteAddr,
  1472.                                  bgpExtPeerLastError,
  1473.                                  bgpExtPeerState,
  1474.                                  bgpIntPeerRemoteAddr,
  1475.                                  bgpIntPeerLastError,
  1476.                                  bgpIntPeerState      }
  1477.                     DESCRIPTION
  1478.                          "The BGPBackwardTransition Event is generated
  1479.                           when the BGP FSM moves from a higher numbered
  1480.                           state to a lower numbered state."
  1481.                     ::= 2
  1482.  
  1483.                END
  1484.  
  1485.  
  1486. 6.  Acknowledgements
  1487.  
  1488.    We would like to acknowledge the assistance of all the members of the
  1489.    Interconnectivity Working Group, and particularly the following
  1490.  
  1491.  
  1492.  
  1493. Expiration Date March 1994                             [Page 25]
  1494.  
  1495.  
  1496.  
  1497.  
  1498.  
  1499. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  1500.  
  1501.  
  1502.    individuals:
  1503.  
  1504.                 Yakov Rekhter, IBM
  1505.                 Rob Coltun, University of Maryland
  1506.                 Guy Almes, ANS
  1507.                 Jeff Honig, Cornell Theory Center
  1508.                 Marshall T. Rose, PSI, Inc.
  1509.                 Dennis Ferguson, ANS
  1510.                 Mike Mathis, PSC
  1511.                 John Krawczyk, Wellfleet Communications Inc.
  1512.                 Curtis Villamizar, ANS
  1513.                 Dave LeRoy, Pencom Systems
  1514.  
  1515.  
  1516.  
  1517. 7.  References
  1518.  
  1519.  
  1520.    [1] Cerf, V., "IAB Recommendations for the Development of Internet
  1521.        Network Management Standards", RFC 1052, NRI, April 1988.
  1522.  
  1523.    [2] Cerf, V., "Report of the Second Ad Hoc Network Management Review
  1524.        Group", RFC 1109, NRI, August 1989.
  1525.  
  1526.    [3] Rose M., and K. McCloghrie, "Structure and Identification of
  1527.        Management Information for TCP/IP-based internets", RFC 1155,
  1528.        Performance Systems International, Hughes LAN Systems, May 1990.
  1529.  
  1530.    [4] McCloghrie K., and M. Rose, "Management Information Base for
  1531.        Network Management of TCP/IP-based internets", RFC 1156, Hughes
  1532.        LAN Systems, Performance Systems International, May 1990.
  1533.  
  1534.    [5] Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple
  1535.        Network Management Protocol", RFC 1157, SNMP Research,
  1536.        Performance Systems International, Performance Systems
  1537.        International, MIT Laboratory for Computer Science, May 1990.
  1538.  
  1539.    [6] McCloghrie K., and M. Rose, Editors, "Management Information Base
  1540.        for Network Management of TCP/IP-based internets", RFC 1213,
  1541.        Performance Systems International, March 1991.
  1542.  
  1543.    [7] Information processing systems - Open Systems Interconnection -
  1544.        Specification of Abstract Syntax Notation One (ASN.1),
  1545.        International Organization for Standardization, International
  1546.        Standard 8824, December 1987.
  1547.  
  1548.    [8] Information processing systems - Open Systems Interconnection -
  1549.        Specification of Basic Encoding Rules for Abstract Notation One
  1550.  
  1551.  
  1552.  
  1553. Expiration Date March 1994                             [Page 26]
  1554.  
  1555.  
  1556.  
  1557.  
  1558.  
  1559. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  1560.  
  1561.  
  1562.        (ASN.1), International Organization for Standardization,
  1563.        International Standard 8825, December 1987.
  1564.  
  1565.    [9] Rose, M., and K. McCloghrie, Editors, "Concise MIB Definitions",
  1566.        RFC 1212, Performance Systems International, Hughes LAN Systems,
  1567.        March 1991.
  1568.  
  1569.    [10] Rose, M., Editor, "A Convention for Defining Traps for use with
  1570.         the SNMP", RFC 1215, Performance Systems International, March
  1571.         1991.
  1572.  
  1573.    [11] Rekhter, Y., and Li, T., "A Border Gateway Protocol 4 (BGP-4)",
  1574.         Internet Draft, T.J. Watson Research Center, IBM Corp.,
  1575.         cisco Systems, June 1993.
  1576.  
  1577.    [12] Rekhter, Y., and P. Gross, Editors, "Application of the Border
  1578.         Gateway Protocol in the Internet", RFC 1268, T.J. Watson
  1579.         Research Center, IBM Corp., ANS, October 1991.
  1580.  
  1581.  
  1582. 8.  Security Considerations
  1583.  
  1584.    Security issues are not discussed in this memo.
  1585.  
  1586.  
  1587.  
  1588. Authors' Addresses
  1589.  
  1590.    Steven Willis
  1591.    Wellfleet Communications Inc.
  1592.    15 Crosby Drive
  1593.    Bedford, MA 01730
  1594.  
  1595.    Phone: (617) 275-2400
  1596.    Email: swillis@wellfleet.com
  1597.  
  1598.  
  1599.    John Burruss
  1600.    Wellfleet Communications Inc.
  1601.    15 Crosby Drive
  1602.    Bedford, MA 01730
  1603.  
  1604.    Phone: (617) 275-2400
  1605.    Email: jburruss@wellfleet.com
  1606.  
  1607.  
  1608.    John Chu
  1609.    IBM Corp.
  1610.  
  1611.  
  1612.  
  1613. Expiration Date March 1994                             [Page 27]
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619. INTERNET DRAFT                 BGP-4 MIB                 August 18, 1993
  1620.  
  1621.  
  1622.    P.O.Box 218
  1623.    Yorktown Heights, NY 10598
  1624.  
  1625.    Phone: (914) 945-3156
  1626.    Email: jychu@watson.ibm.com
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.  
  1669.  
  1670.  
  1671.  
  1672.  
  1673. Expiration Date March 1994                             [Page 28]
  1674.  
  1675.  
  1676.